home *** CD-ROM | disk | FTP | other *** search
/ Multimedia 4 / multimedia 4.iso / utility / win31 / xantippe / _eadme.txt / _eadme.txt
Encoding:
Text File  |  1993-11-17  |  8.8 KB  |  206 lines
  1.  
  2. Xantippe - The Information Structuring Workbench
  3. ------------------------------------------------
  4.  
  5. XANTIPPE.EXE        - The executable.
  6. XANTIPPE.SYM        - The symbol table.
  7. XANTREAD.EXE        - The reader executable (commercial version)
  8. XANTREAD.SYM        - The reader symbol table (commercial version)
  9. XANTIPPE.XAN        - An example data file.  The data file was used
  10.                           to create the help system for Xantippe.
  11. XANTIPPE.HLP        - The Xantippe help file.
  12. README.TXT          - A Read Me File.
  13.  
  14. (Example directory only found in Commercial Release)
  15. EXAMPLE Directory   - A directory containing sample Xantippe projects.
  16.    LIFF Directory    - The Meaning of Liff
  17.  
  18. Example - The Meaning of Liff
  19. -----------------------------
  20. This Xantippe example project demostrates one possible use for Xantippe.
  21. The Meaning of Liff project was created by Michael Malcolm Andersen of 
  22. Denmark based on the book of the same name by Douglas Adams and
  23. John Lloyd.  You can contact Michael via CompuServe 100023,3665.
  24.  
  25. If you have a Xantippe project you would like to include in the Xantippe
  26. distribution, please contact IRIS Media Systems.  We are looking for
  27. Xantippe project that take advantage of Win3.1 features (Macros and
  28. Hot Spots) or OS/2 features (HyperGraphics).
  29.  
  30. Problems
  31. --------
  32. Although every effort has been made to ensure Xantippe is bug free,  if you
  33. do encounter any problem please report them to IRIS Media Systems.
  34. If you encounter any crashes, please run Dr. Watson, DRWATSON.EXE, before
  35. running Xantippe.  If a crash does occur Dr. Watson will create a file
  36. DRWATSON.LOG which will give us information about the crash.  Please send
  37. this file along with an explanation of what actions caused Xantippe to
  38. crash to IRIS Media Systems.
  39.  
  40. Minor Updates
  41. -------------
  42. Version 2.01:
  43. 1)  Fixed problem with .br commands appearing in final OS/2 help files.
  44.  
  45. Version 2.02:
  46. 1)  Fixed problem with creating HyperMacro links with references to
  47.     secondary windows.
  48. 2)  Commercial version now includes a Xantippe reader, which can be used
  49.     as an alternative to distributing documents using the Windows or OS/2
  50.     Help System.  The Reader can be distributed freely.
  51. 3)  Fix problem with keyword search hanging system.
  52.  
  53. Version 2.03
  54. 1)  Fixed problem loading RTF files created by QDHelp.
  55.  
  56. What's New: April 1993 (2.0)
  57. ----------------------------
  58.  
  59. 1)  Support for OS/2 2.0 IPF Help.  Xantippe supports HyperJump links and
  60.     HyperPopup links.  HyperJump links become hd (header) links.  HyperPopup
  61.     links become fn (footnote) links.  HyperMacro links are not supported
  62.     and are converted to HyperJump links during IPF conversion.  Bitmaps
  63.     can be referenced from text cards using the Windows WinHelp convention
  64.     of bml, bmc, and bmr.  Xantippe hyperarea links will be export to
  65.     the IPF file as artlinks.
  66.  
  67. 2)  Create RTF Document file.  Export the Xantippe project to an RTF file
  68.     organized linearly.
  69.  
  70. 3)  Create Text Document file.  Export the Xantippe project to a Text file
  71.     organized linearly.
  72.  
  73. 4)  Search functions.  Ability to do a search for any text phrase in the 
  74.     Xantippe project.  Ability to search for a text phrase in the name
  75.     of any card.  Ability to do keyword searches.
  76.  
  77. 5)  New Build Dialog.  When build function is invoked a new dialog will
  78.     prompt the user to specify the name of the help file to create and
  79.     the help compiler to use.
  80.  
  81. 6)  Support for creating a single WinHelp file from multiple Xantippe
  82.     project file.  When WinHelp build is invoked and multiple Xantippe
  83.     projects are loaded the user will be prompted as to whether to 
  84.     combine the Xantippe projects into a single WinHelp file.
  85.  
  86. 7)  Ability to remove card ids from final help file.  See Preferences.
  87.  
  88. 8)  Quick browser update that does not show hyperlinks from text cards
  89.     to other cards in the system.  See Preferences.
  90.  
  91. 9)  Support for Windows 3.1 WinHelp.  Xantippe will create RTF, HPJ, and
  92.     H files for the Windows 3.1 help compiler.  Unfortunately SHG files
  93.     must be created outside of Xantippe with the Hot Spot Editor (SHED.EXE)
  94.     and referenced in text cards with the bmc,bml,and bmr commands.  Use
  95.     the symbolic names for cards in the .H file when creating links with
  96.     the Hot Spot editor.  If you have to create help files for Windows 3.0
  97.     WinHelp or OS/2 2.0 (which don't recognize SHG files),  Xantippe will
  98.     automatically convert SHG files referenced in text cards to BMP files.
  99.  
  100. 10) New link type: HyperMacro.  Used in Windows 3.1 WinHelp to execute
  101.     a command.  Macro is assigned to link with Modify command.  The Macro
  102.     is changed by changing the text comment associated with the hyperlink.
  103.  
  104. 11) Ability to Modify hyperlink properties.  The type of hyperlink can
  105.     be changed and a text comment (HyperMacro) can be associated with
  106.     the link.
  107.  
  108. 12) Xantippe will now save the fact that a card is iconified at save time.
  109.     When the project is loaded again the card will be opened in an iconied
  110.     state.
  111.  
  112. What's New: January 1992 (1.6)
  113. ------------------------------
  114.  
  115. 1) Xantippe can now create the HPJ and cross-reference header file for
  116.    Windows Help.  Using the Build command you  can create these files
  117.    and run the help compiler from within Xantippe.
  118.  
  119. 2) Xantippe can create data files for the QuickHelp compiler, helpmake.
  120.    You can either create the file with a Save As and run the compiler
  121.    yourself or use the Build command to create the QuickHelp data file
  122.    and run the compiler.
  123.  
  124. 3) Xantippe can read RTF files.  Using the Open command you have the option
  125.    of opening a Xantippe data file or RTF data file.  Each page in the RTF
  126.    file is placed in its own text card.  You must have hard page breaks or
  127.    the whole document will appear in one text card.  Once you have exported
  128.    your Xantippe project to RTF, you cannot re-read the project back
  129.    into Xantippe.  If you do, you will lose the network structure.
  130.  
  131. 4) Under the Project menu there is a new Preferences option.  From this
  132.    option you can set whether card ids are to be displayed and edited as
  133.    hex or decimal values.  You can also set a flag to decide if you should
  134.    be prompted to rename a card when you create it.
  135.  
  136. 5) You can now use the cards in the browser when linking.  When you create
  137.    a link you can now click on the name of the card in the browser as well
  138.    as the cards window.  Remember cards that are underlined in the browser
  139.    are just placeholders and are not "real" cards, therefore you cannot
  140.    click on these card names to create a link.
  141.  
  142. 6) When referencing bitmaps from within a text card the backslashes before
  143.    the curly brackets are no longer needed and should be removed.
  144.    What was:
  145.    \\\{bml MYBITMAP.BMP\\\}
  146.    Should now be:
  147.    {bml MYBITMAP.BMP}
  148.  
  149. 7) Xantippe will automatically create a backup of an old project before
  150.    writing a new project over it.  The backup will have the extension BAK.
  151.  
  152.  
  153. I'd appreciate any feedback or bug reports.  I am currently trying to
  154. improve the online documentation so any comments on the documentation
  155. would be greatly appreciated.
  156.  
  157. Xantippe has not been completely tested with double byte character sets
  158. i.e. Japanese, Chinese, and Korean.  If you have any problems running
  159. with a double byte character set please report the problem to 
  160. IRIS Media Systems.
  161.  
  162. If the text in the text cards is too small, you can change
  163. the font height from the 'template.dat' file.  This is not documented
  164. and you do this at your own risk.  Make sure you have a backup
  165. of the 'template.dat' file in case something goes wrong.  If you
  166. delete the 'template.dat' file, Xantippe will re-create a default
  167. file.
  168.  
  169. NOTE TO UNREGISTERED SHAREWARE USERS:
  170. If you find this program useful, please register it!
  171.  
  172. HOW TO ORDER XANTIPPE:
  173. Unfortunately, we cannot accept credit cards.  Payment must be by
  174. check or money order in US dollars drawn on an American bank.  We can
  175. accept certain foreign currencies, certain foreign bank drafts, and
  176. bank transfers please contact IRIS Media Systems for more details.
  177.  
  178. Xantippe - Shareware         US$15.00
  179.    Limited version with mini-manual.
  180. Xantippe - Commercial        US$99.00
  181.    Enhanced version with complete manual.
  182.       1) Create projects greater than 30 cards.
  183.       2) Work with multiple projects.
  184.       3) Ability to print.
  185.  
  186. California Residents add 8.25% sales tax
  187.  
  188. Shipping and Handling: US$5.00 inside United States
  189.                        US$10.00 outside United States
  190.                        Express shipping available, contact IRIS Media.
  191.  
  192.  
  193. Thanks...
  194. Rodney S.K. Lai
  195.  
  196. IRIS Media Systems
  197. 1684 Locust St. Suite #125
  198. Walnut Creek, CA 94596
  199. Tel: +1 510 256 4673
  200. Fax: +1 510 256 6353
  201. CompuServe: 76547,706
  202. AOL: RodneyLai
  203. GEnie: RODNEY.LAI
  204. InterNet: rlai@netcom.com
  205.  
  206.